home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / networking / amosaic / amosaichotlist.lha / Mosaic / AMHotlist.doc < prev   
Text File  |  1994-06-24  |  6KB  |  134 lines
  1.  
  2.  
  3. *******************************************************************************
  4.  
  5.                  A M I G A     M O S A I C    H O T L I S T
  6.  
  7.                      AMHotlist, (c) 1994, Berend Ozceri
  8.  
  9. *******************************************************************************
  10.  
  11. I. Legalities
  12.  
  13.   This program is provided as is, as a public domain program and no guarantees
  14. are made by the author. As Dave Haynie quoted Jimmy Buffet in the A3000/A4000
  15. hardware notes, "What works for me, might work for you." Use this program at
  16. your own risk as I do not assume any responsibility for any physical/electrical
  17. /mental/etc damage caused by this program.
  18.  
  19.   Feel free to distribute this program as much as you want but do not make any
  20. profit from it! If you like it some much that you want to send me a donation,
  21. feel free to do so! ;)
  22.  
  23.   Please report any bugs/problems to me. You can contact me at:
  24.   
  25.   E-Mail: bo24@andrew.cmu.edu
  26.  
  27.   Snail-Mail: Berend Ozceri
  28.               Carnegie Mellon University
  29.               Box 4930
  30.               5115 Margaret Morrison
  31.               Pittsburgh, PA 15213
  32.  
  33.   This program uses MUI. MUI is (c) 1993,1994 by Stefan Stuntz.
  34.  
  35.  
  36. II. Introduction
  37.  
  38.   As you well know, the AMosaic development team has done a great job of
  39. porting Mosaic to the Amiga, bringing an invaluable net resource to the Amiga
  40. world. However, one of the shortcomings of the latest version of AMosaic
  41. (version 1.2) is the support for hotlists (or lack thereof ;) ). Apparently the
  42. developers tried to address this problem by putting in an ARexx script into the
  43. distribution to create pseudo-hotlist support. However, I find the idea of
  44. using a seperate HTML page as a hotlist a major kludge. So what did I do? I
  45. performed a smaller kludge! I wrote an MUI program that can be invoked from
  46. AMosaic (via ARexx) and will give you complete hotlist control.
  47.  
  48.  
  49. III. Installation
  50.  
  51.   The installation is straightforward. Copy the executable AMHotlist to any
  52. directory you want. Add the following lines to your ENVARC:Mosaic/Prefs:
  53.  
  54. RexxMacro1 Add to Hotlist | "ADDRESS COMMAND 'C:RUN <>NIL: MOSAIC:AMHotlist QUICKADD'"
  55. RexxMacro2 Hotlist... | "ADDRESS COMMAND 'C:RUN <>NIL: MOSAIC:AMHotlist'"
  56.  
  57. (Make sure you replace MOSAIC:AMHotlist with wherever you decide to install the
  58.  executable in your system. For example, if you install the AMHotlist program
  59.  in your C: directory, replace the MOSAIC:AMHotlist in those lines with
  60.  C:AMHotlist)
  61.  
  62.   Copy the .mosaic-hotlist-default file to your ENVARC: directory as follows:
  63.  
  64.     COPY .mosaic-hotlist-default ENVARC:Mosaic
  65.  
  66.   Copy the ENVARC:Mosaic directory to ENV:Mosaic as follows:
  67.  
  68.       COPY ENVARC:Mosaic ENV:Mosaic
  69.  
  70.   You are set!
  71.  
  72.   (Note: The hotlist program requires you have a MUI, but since you are already
  73. using AMosaic that step should already have been taken care of.)
  74.  
  75.  
  76. IV. Usage
  77.  
  78.   Start AMosaic. Under the Rexx menu you should see two entries "Add to
  79. Hotlist" and "Hotlist..." Select "Hotlist..." The hotlist window will open on
  80. your default MUI screen (this is normal for any MUI program that does not have
  81. any configuration saved). If you are running AMosaic on a screen other than the
  82. default screen, close the hotlist window, start up MUIPrefs and set
  83. AmigaMosaic-Hotlist's screen prefs so that it opens on that screen too. Then
  84. reopen the window. If you copied a .mosaic-hotlist-default file to your
  85. ENV:Mosaic directory, it should automatically have been loaded by now.
  86.  
  87.    i) Adding New Entries
  88.  
  89.      There are two ways to add new entries to the hotlist. The first way is by
  90.    using the "Add" button in the hotlist window. If you click on "Add" a dialog
  91.    window will come up preloaded with the information regarding the current
  92.    page loaded into AMosaic. If you want to add that page as is, just click on
  93.    "Done", and it will be added. If you want, you can do editing on the "Title"
  94.    and "URL" fields before you click on "Done". If you decide not to add, just
  95.    click on "Cancel"
  96.  
  97.      The other way to add an entry to the hotlist is by using the "Add to
  98.    Hotlist" menu option. If you perform this menu selection, AMosaic's current
  99.    page will be added to your hotlist without bringing up any sort of dialog
  100.    window. NOTE: IF YOU HAVE THE HOTLIST WINDOW OPEN WHEN YOU SELECT "Add to
  101.    Hotlist" THE LISTVIEW WILL NOT BE UPDATED. THIS IS NORMAL (A SHORTCOMING OF
  102.    THE PROGRAM, I WROTE THIS IN ONE NIGHT, AND RUSHED IT OUT THE DOOR!). IN
  103.    THIS CASE JUST CLOSE THE HOTLIST WINDOW AND REOPEN IT AND EVERYTHING WILL BE
  104.    FINE.
  105.  
  106.      Note that everytime you add an item, AMHotlist will update the
  107.    .mosaic-hotlist-default file in your ENVARC: and ENV: directories. 
  108.      
  109.  
  110.    ii) Deleting Entries
  111.  
  112.      Deleting a hotlist entry is easy. Just select the hotlist entry from the
  113.    listview and click on "Delete"
  114.  
  115.  
  116.    iii) Editing Entries
  117.  
  118.      If you decide at any point to change anything about a hotlist entry that
  119.    you already have, use the "Edit" button. Selecting a hotlist entry and
  120.    clicking on "Edit" will bring up an editing dialog. Edit the entry as you
  121.    wish and click on "Done" if you want the changes to take effect. If you want
  122.    to scratch the changes, click on "Cancel"
  123.  
  124.      The editing window is asynchronous from the rest of the program so you can
  125.    be double-clicking on entries to jump to while the edit window is open.
  126.  
  127.  
  128.    iv) Jumping to Entries
  129.  
  130.      If you want to jump to an entry, just double click on it! Presto! You are
  131.    there. You will realize that when you perform a jump, the hotlist window
  132.    will be put to sleep until AMosaic confirms via ARexx that the jump has
  133.    worked.
  134.